home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / tell_room < prev    next >
Text File  |  2001-04-06  |  2KB  |  42 lines
  1. SYNOPSIS
  2.         void tell_room(string|object ob, string str)
  3.         void tell_room(string|object ob, string str, object *exclude)
  4.         void tell_room(string|object ob, mixed *msg)
  5.         void tell_room(string|object ob, mixed *msg, object *exclude)
  6.  
  7. DESCRIPTION
  8.         Send a message str to all living objects in the room ob. ob
  9.         can also be the name of the room given as a string. If a
  10.         receiving object is not a interactive user the lfun
  11.         catch_tell() of the object will be invoked with the message as
  12.         argument. If living objects define catch_tell(), the string
  13.         will also be sent to that instead of being written to the
  14.         user. If the object is given as its filename, the driver
  15.         looks up the object under that name, loading it if necessary.
  16.         If array *exclude is given, all objects contained in
  17.         *exclude are excluded from the message str.
  18.  
  19.         If the second arg is an array, catch_msg() will be called in
  20.         all listening livings.
  21.  
  22. EXAMPLES
  23.         tell_object(environment(this_player()), "Hi!\n");
  24.         
  25.         Just send a simple "Hi!" to all livings in the current.
  26.         
  27.         Object 1 (living):
  28.            void catch_tell(string str) {
  29.               write("Received: "+str+"\n");
  30.            }
  31.         Object 2:
  32.            void func() {
  33.               ...
  34.               tell_room(environment(this_player()), "HiHo!\n");
  35.               ...
  36.            }
  37.         
  38.         This examples shows how tell_room() together with catch_tell() works.
  39.  
  40. SEE ALSO
  41.         write(E), say(E), tell_object(E), catch_tell(A), catch_msg(A)
  42.